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1. General Description of the Release 


Throughout this Release Notice the term S/Series stands for 
the current members of the family: S/80, S/120, S/221, 
S /222, S/280, S/320, S/480, and S/640. 


The 6.2 S/Series CTIX ordered by (SAC-20Bx, SAC-2014x, 
SAC-20Cx, SAC-20Fx) contains documents: 


Title Part Number 
6.2 S/Series CTIX 
Release Notice B-09-01975-01-D 
1.13 S/Series Remote I/O Processor 
Release Notice B-09-02078-01-B 


Programmer’s Notes for 
C Cross-Compilation & Flexnames B-09-00689-01-B 


The 6.2 S/Series CTIX software release comprises 1 Quarter- 
Inch Tape: 


Name Part Number 
Raw/Update Installation Tape 71-03352-01 


The 6.2 S/Series package is documented by the following 
manuals: 


Title Part Number 
CTIX Operating System, Ver C, 
Second Edition, Volumes 1-4 DAC-200 


S/Series CTIX Administrator’s Guide DAC-220 
CTIX Administration Tools Manual DAC-210 


Additional CTIX documentation that can be ordered: 


Title Part Number 
Programmer’s Guide: CTIX 
Supplement DAC-180 
S/Series Diagnostics Manual DHC-120 


$/80 and $/280 Diagnostics Manual DHC-560 
CTIX Network Administrator’s Guide DNC-180 


Writing MIGHTYFRAME Device 
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Drivers DAC-120 


Note that this manual was written for 5 XX CTIX; 
however, it is the only reference on the Kernel 
Debugger, on the use of the Interactive Loader, 
on integration of customized device drivers into 
OCTIX, and on the Kernel Subroutines available to 
the writer of device drivers. 


AT&T UNIX System V Release 3.2 Documentation: 


Title Part Number 

Documenters Workbench Technical 

Reference DAU-450 
Documenters Workbench User’s 

Guide DAU-460 
Network Programmer’s Guide DAU-430 
Streams Programmer’s Guide DAU-410 
Streams Primer DAU-420 
Assist User’s Guide DAU-440 
User’s Guide DAU-300 
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2. Changes from 6.10 CTIX Release 
a 2.1 Origins of the Release 


This release of CTIX corresponds to AT&T UNIX™ System V 
o~ Release 3.2, with the following exceptions: 


1. The new AT&T 2K filesystem is replaced by a CTIX 4K 
filesystem. 


2. New AT&T functionality for Ip(1), access to printed 
forms and easier administration of Ip interface filters, is 
not provided. 


3. The new AT&T master/slave stream pipe driver is not 
included in 6.2 CTIX. The comments in the source code 
indicated that this driver will not be present in future 
releases. 


2.2 Major Differences from Previous Releases 


This section briefly states the major differences between the 
6.10 and 6.2 S/Series CTIX release. 


1. Single binary tape: 


or" e This means all commands "do the night thing’ on all 
S/Series machines. 


e There are two kernels, one for $/640' and one for 
$/320? and S/80.* There is a loader on the tape that 
can pick which kernel to bring off the tape. 


e A single install tape requires a single loader that knows 
about all machine architectures. The size of this 
loader will be much larger than the current maximum 


1. For the purposes of this document, there are only four different machine 
architectures, and S/640 will imply S/480 and S/640, as these have the 
exact same software interface. 

2. Likewise, S/320 will imply $/120, S/22x, and S$/320, as these have the 
exact same software interface. 


3. In most contexts $/80 will imply $/80 and S/280, as these have nearly the 
same software interface. In cases where there are differences, the specific 
machine name will be used. 
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size allowed on the disk (30KB). To work around this 
limit, there will be three different loaders: 


i. The “knows all” (normal) loader for the install 
tape, and machines with room in partition 0 for a 
larger loader. This loader has all presently 
known boot device drivers built in. Its size is 
38K. 


ii. A small version of the loader (without tape 
drivers), for the boot disks with only 30KB of 
space for the loader. Its size is 30K. 


iii. The interactive version of the loader, which will 
be another "knows all” loader. Its size is 40K. 


System disks with less than 30 KB of space for a 
loader must be raw installed. The partition 0 size 
must increase by 98 KB to accommodate the new 
disk description file in /usr/lib/iv. The disk 
description files in /usr/lib/iv have been changed to 
specify 128KB for the loader area. 


When raw installing, the normal "knows all” loader is 
used, and a larger area for the loader is reserved in 
partition 0. When updating, if there is space in 
partition 0 (maybe by stealing blocks from the dump 
area if present), the normal loader is installed. If 
space cannot be found, then the small loader must be 
used. 


e As a side-effect of the single binary tape, the stock 
kernel provided upon installation includes drivers for 
devices that might not be present on a given machine. 
For example, the scsitape driver and the QIC-2 driver 
are both present, but the QIC-2 hardware is present 
only on the $/320. Also the V/SMD3200 SMD driver 
is included. Optimum use of memory would require 
using the KFIG Group to build a new kernel with an 
appropriate dfile for that machine. 


2. Support for S/280: hine(1) and syslocal(2) are enhanced to 
allow user programs to configure the S/280. 
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A STREAMS-based tty driver is provided, and is now the 
default tty driver. Initial tests show that for certain 
situations, the STREAMS-based tty driver is faster than 
the non-STREAMS driver. 


The corresponding STREAMS-based sxt and iop drivers 
are also provided. Note that the sxt driver (shell layers) 
does not work on RIOP ports. 


The old wxt driver, provided with CTAM, does not work, 
except on Convergent cluster ports, including RIOP ports, 
until a new version is released which supports STREAMS. 


The old and new STREAMS-based SLIP drivers are 
provided. The RIOP tty driver is not yet converted to 
STREAMS. sslattach(1M) can detect which tty driver is in 
use and call the appropriate SLIP driver. 


You must save your old /ete/netcf customizations and 
add them to the new version of the file or SLIP may fail. 


Entries for the Convergent Technologies DC2400, a 
Hayes Smart Modem 2400 compatible, are now included 


in /usr/spool/uucp/Dialers. 


adman(1) now allows configuration of any one Ethernet 
controller; the controller number is not limited to enO. 
You must configure manually for multiple Ethernet 
controllers. 


The installation of the CROSS Group now works 
correctly. It will overwrite the SOFTWARE Floating 
Point libraries in /usr/lib if you request it. The 
installation will also remove /cross if you request that be 
done. 


Selected AT&T System V Release 3.2 features as follows: 


e New filesystem size: Instead of AT&T’s 2K 
filesystem, 6.2 S/Series CTIX incorporates a 4K 
filesystem. The root filesystem cannot be a 4K 
filesystem, because the default kernel has no 4K 
buffers configured for it. Note that to enable 4K 
filesystem mounts, the kernel] must either be relinked 
or reconfigured using uconf(1M). mkfs(1M) has a new 
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option for creating 4K file systems. Refer to the new 
man page. 


e An enhanced curses($X) library is included. It 
provides improvements to support color terminals. 
Support for the CT local features for line drawing has 
been dropped. The non-standard keywords Idul, Idur, 
Idht, Idbr, Idbl, and Idatt, have been deleted. 
Equivalent features are now supported by curses, using 
the standard construct acse. 


The terminfo description file keywords goto_func_line 
and leave_func_line, added to support Convergent PT 
and GT terminals, have been deleted. Programmers 
who need to address the PT/GT status line should use 
the AT&T standard keywords to_status_line and 
from_status_line. 


e Enhanced security features are included. The shadow 
password file, a program pwconv(1M) to convert to 
using the shadow file, and a program pwunconv(1M) to 
revert to not using the shadow file are provided. The 
rlogin(1) and telnet(1) commands are also enhanced to 
handle the shadow password file. 


e The new command passmgmt(1M) is provided which 
helps super-user shell scripts to make controlled 
changes to the password files /ete/passwd and 
/etc/shadow. 


e The uucp group has been added to the file /ete/group. 
It is the group ID of most uucp files and commands. 


10. New features in the AT&T System V Release 3.2 kernel: 


e If you are removing a directory in a S51K file system 
and the sticky bit is set on the parent directory, then 
this directory is deleted only when: 


1. The deletion is performed as superuser. 


2. The deletion is performed as owner of the 
directory. 


3. The deletion is performed as owner of the parent 
directory. 
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4. The deletion is performed when the directory is 
writable. 


e When the user executes chmod(1) to turn on the sticky 


bit in a S51K file system and is not root, chmod(1) +t 
is allowed on directories only. 


2.3 Other Differences 


Other changes from 6.10 OCTIX are listed in this section. 
1. New features from 6.10 CTIX Addendums: 


Changes to kernel file system services to support NFS 
(without Yellow Pages). 


For the $/320 and S/640, support for the SCSI/RS-232 
Expansion Board. 


For the $/320, there is a new version of the QIC-2 
Tape driver. 


Changes to scsimap(1M) and adman(1M) to recognize 
SCSI disks and the SCSI/RS-232 Expansion Board. 


Fixes for the VME-based Half-Inch Tape driver. 


Support for the Cipher SCSI Half-Inch Tape Drives, 
F880S and M9908. 


S/80 SCSI/Ethernet Expansion board support, with a 
new scsi driver and system utilities. 


Changes to adman(1) for recognition of the S/80 RS- 
232 Expansion board and for correct modifications of 
/etc/inittab entries. 


2. Other new features: 


Support for the MC68882 Floating Point Co-processor 
on the $/280. 


The MC68882 is equivalent to the MC68881. If the 
MC68882 is present on an S/280, hinv(1M) reports 
that an MC68881 is present. If you use the output of 
hinv(1M) in a script, take this into account. 


Throughput improvements to IOP that increase total 
character throughput on transmit from 20K chars/sec 
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to about 24K chars/sec. Throughput on receive has 
yet to be measured, but should be similar. 


e The new command serstat(i1M) now supports IOP 
controlled ports. 


e fuser(1M) and fusage(1M) are enhanced to support 
NFS. 


e cu(1) and wucp(1) now run over TLI connections. 


e The size of the callout table is now configurable by 
uconf(1M). The variable name is v_call for the callout 
table size. 


e There is a new adman capability, createdev(1M) in 
/usr/local/bin that will create device nodes given the 
type of device, major device major number, and 
starting minor device number. Refer to the new man 
page createdev(1M) for more information. 


2.4 Other New Features 


What follows are brief descriptions of other new or different 
features. Most were available in 6.10 CTIX and are included 
here for those upgrading from a 5.XX CTIX release. 


1. 


A new program, tio(1) has been added, which uses several 
buffers in order to keep the tape device streaming. When 
tio(1) is used with a Half-Inch Tape drive, the Interphase 
V/Tape 3209 VME controller board must be at the 
currently shipped Revision Level for best performance. 


If your system supports the VME bus and is using the 
Interphase V/SMD 3200 disk controller, the default DMA 
burst count has been changed from 8 to 2 words. This 
parameter, gdvms32dmaburst, is also now configurable in 
/ete/system using uconf(1M). This change was made to 
minimize a problem with the CMC Ethernet VME 
Controller. 


The gap sizes for SMD disks on the Interphase V/SMD 
3200 controller have been changed from Gapl = 16 and 
Gap2 = 16 to Gapl = 12 and Gap2 = 12 in the disk 
description files in /usr/lib/iv. It is advisable, especially 
for the Northern Telecom 750MB drive, to reformat your 
SMD disks using the new gap sizes. (Be sure to backup 
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your disks before doing the format.) 
2.4.1 Enhanced Cluster Driver 


There are some enhancements to the Terminal Cluster Driver. 


The first change is in the way /dev/ttynnn numbers are 
assigned to RS-422 lines. In /etc/inittab in 6.10 and 5.XX 
CTIX, there are eight /dev/tty??? device nodes per RS-422 
line. 


0 1 2 3 
256-263 264-271 272-279 280-287 
cl_defdrops=8 | 256-263 264-271 272-279 280-287 


Prior to this release, if you changed cl_defdrops (drops per 
line) in /ete/system, the /dev/ttynnn numbers were not 
correct. If you had changed the drops in /ete/system to two, 
the /dev/ttynnn numbers would have been assigned as follows: 


| tine | 0 1 2 3 
cl_defdrops=2 | 256-257 258-259 260-261 _—262-263 


The new assignments are as follows: 


0 1 2 3 
cl_defdrops=1-8 | 256-263 264-271 272-279 280-287 


256-263 264-271 272-279 280-287 
288-294 296-302 304-310 312-318 


cl_defdrops—9-15 


1. ttys numbers 295, 303, 311, and 319 cannot be assigned 
or opened. 


2. the administrator will have to add entries to /ete/inittab 
when cl_defdrops is greater than 8. 


‘The second change is for support of RS-422 high speed devices 


such as PC Exchange/Vines, RIOP, and Telecluster. These run 
at 1.8M baud versus the PT/GT rate of 307K baud. 
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Note: 


1. Each line on the RS-422 Board will auto-configure to the 
highest speed requested for any one connected device. 


Do not mix high and low speed devices. 
2.4.2 More Open Files Per Process 


The number of open files per process has become configurable 
in the range of 20 to 100. The default is 20. To generate a 
kernel with a larger number of open files specify nofile in your 
/usr/sys/cf/dfile, and do a make(1); refer to the S/Series CTIX 
Administrator’s Guide. 


Note: Any program compiled in 5.XX OTIX that uses fields of 
the user structure that occur after the open file table (such as 
u_arg[], u_signal{], or u_ar0) must be recompiled, since the 
offsets of the fields in the user struct have changed from those 
of 5.XX CTIX and earlier. 


Warning: The stdio library still has a limit of 20 open files: 
although you may have 100 file descriptors for open files, at 
most 20 of them can be acquired by using fopen(3). 
Attempting to open the twenty-first file, fopen(3) will return the 
value 24 in errno, which is EMFILE, Too many open files. 


2.4.3 Kernel Support for the SCSI/RS-232 Expansion Board 


There are changes to the SCSI driver for SCSI/RS-232 
Expansion Board support. 


In order to configure the system for SCSI/RS-232 board(s), 
entries in the !SCSIMAP section of /ete/system must be 
added to use the SCSI devices. 


To configure your system for the SOSI/RS-232 upgrade, take 
the following steps: 


1. Shut down the system and install the SCSI/RS-232 board 
into the first open I/O slot. 


2. Power up and reboot the system. Login as root. 


3. Execute: hinv -p. 
If the additional board is not seen, check the number of 
controllers using the DMA channels. Note: The bus 
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number to use for SCSI entries is equal to the reportéa——___ 


slot number. 


4, Edit the !SCSIMAP section of /ete/system. 
(Note: ALL disk entries are “disk-cOdN’. ALL tape 
entries are "tape-dNV’.) 


5. Create device node entries in /dev/rdsk, /dev/dsk, and 
/dev/rmt using mknod(1M). See the Subsection on 
"Creation of SCSI Disk Device Nodes” for creation of disk 
device nodes. If your system is an $/320, see the later 
Section on "Support for the SCSI Half-Inch Tape Drive” for 
creation of tape device nodes. 


6. Execute: scsimap -u 
Execute: hinv -p 
(Note: All SCSI disk units should be displayed. No SCSI 
tape units are shown by hinv(1M).) 


See the S/Series CTIX Administrator’s Guide for details on 
configuring SCSI disks. 


If your system is an $/320, note that there are only 2 DMA 
interrupt channels on the system. This means that the 
SCSI/RS-232 Board cannot be supported if a VME Interface 
Board and an IOP/RS-422 Board are already installed. If there 
is no VME Interface Board, the SCSI/RS-232 Board chooses 
the VME DMA channel, otherwise it takes the IOP/RS-422 
channel. If either a VME Interface Board or an IOP Board is 
already installed, then the system cannot support a mix of 
COMBO (SOCSI/RS-232 or SCSI/Ethernet) boards. The first 
type of COMBO board is recognized and the second is ignored. 


If your system is an S/640, there are 3 DMA channels on the 
system. The SCSI/RS-232 Board always takes one of the non- 
VME DMA channels. 


The default entries for onboard SCSI-based systems in 
/ete/system look like: 


ISCSIMAP 
disk-cOdO bus—0 target==6 lun—0 parity reselect 
tape-d0 bus=0 target—1 lun=0 parity reselect 
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The S/320 systems do not have an onboard SCSI bus, so the 
first bus number that can be used is 1. The default entries for 
5/320 systems in /ete/system look like: 


!ISCSIMAP 
disk-c0Od0 bus=1 target—6 lun=0 parity reselect 
tape-d0 bus=1 target—1 lun=0 parity reselect 


Warning: for bus O targets 4 and 5 must be disks, not tapes, 
otherwise the system will not boot. 


2.4.4 Support for the SCSI Half-Inch Tape Drive 
The Cipher SCSI Half-Inch Tape drives are supported. 


In order to configure the system for SCSI Half-Inch Tape 
drives, entries in the SCSIMAP section of /etc/system must be 
added. 


To configure your system for additional drives, do the 
following: 


1. Shut down the system and power it off. 
2. Add the new drives (disk or tape). 

3. Reboot the system and login as root. 
4 


Execute: hinv -p 

All SCSI disk units should be displayed. No SCSI tape 
units are shown by hinv(1M)}. You should see the disks 
reported. 


5. Edit the SCSIMAP section of /etc/system. 
(Note: ALL disk entries are “disk-cOdN”’. ALL tape 
entries are "tape-dN’.) 


6. Create device node entries in /dev/rmt using mknod{1M). 
See the later Section on "Creation of SCSI Half-Inch Tape 
Device Nodes” for creation of tape device nodes. 


7. Execute: sesimap -u 
Execute: hinv-p 


8. Add entries for the Half-Inch Tape drive, using the 
default /etc/system !SCSIMAP section lines as 
templates. Be sure the target number is different for each 
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drive on the same bus. hinv(1M) reports which slot 
number the board is in, therefore which bus number to 
use. The default entries plus the Half-Inch tape drive 
look like: 


!ISCSIMAP 

disk-cOd0 bus=O target—6 lun=0 parity reselect 
tape-d0 bus=—0 target—1 lun=0 parity reselect 
tape-d1 bus=0 target—2 lun=0 parity reselect 


Note that an additional field, halfinch, is added to the end 
of the line for the entry for Half-Inch Tape drive, to 
distinguish Half-Inch from Quarter-Inch Tape drive. 


9. 6.2 CTIX does not have device nodes provided for SCSI 
tape drives for the $/320. You must make nodes for the 
tape drives, which are on controller 2. Refer to Chapter 
7, "Configuring Device Drivers and the Kernel”, in the 
S/Series CTIX Administrator’s Guide for more information. 


2.4.5 S/80 SCSI/Ethernet Expansion Board Support 


S/80 SCSI/Ethernet Expansion Board support is provided, with 
a new SCSI driver and system utilities. There is a new version 
of the enet driver, mitienet.o, and there are changes to the 
general disk, SCSI disk, and SCSI tape drivers. A new ioctl 
command, SCSIENET, is added to support SCSI/Ethernet. 
The corresponding modules in kernel libs in /usr/sys are 
changed. In /usr/include/sys, system header files socket.h, 
sesi.h, and if_enp.h are changed, and se_emdh is new. 
System command hinv(1M) is updated, and system initialization 
files /ete/init.d/devices, /ete/rc2.d/S79devices, and 
/etc/enp/enpload are also changed. 


NOTE: be sure that /ete/hosts and /ete/rcopts/NODE are 
correct after the installation is finished. 


Refer to Chapter 7, "Configuring Device Drivers and the Kernel’, 
in the S/Series CTIX Administrator’s Guide for more information. 
2.4.6 Concurrent Support for RFS and NFS 


6.2 CTIX now supports RFS and NFS running concurrently. 
To use RFS and NFS together, you must be running 1.1 RFS. 
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2.5 Bug Fixes 
2.5.1 Bug Fixes in 6.10 CTIX 


The following bugs have been closed since 5.XX CTIX. 
Corrections or the proper feature functionality are described. 


1. 


Getty recognizes B19200 and B38400 in _ the 
/etc/gettydefs file. 


The download image for the IOP Board has been modified 
so that the system does not hang under high character 
throughput levels. 


stty O hangs up the phone line immediately, as it should. 


When shell commands are typed on a system with an IOP 
while output is coming to the terminal, the shell does not 
hang and become unkillable. 


tide(1) has been replaced by infoemp(1), which correctly 
decompiles supported terminfo files. 


Pressing the BREAK key while in cu(1) does not cause 
every other character to be read in. 


The installation update script now asks whether the user 
wants to save /ete/termcap. 


esh scripts run in the background are no longer killed by 
hitting the DELETE key. 


getty and uugetty now correctly recognize the BREAK 
character. 


2.5.2 Bug Fixes from 6.10 CTIX Addendums 
Bug fixes from 6.10 CTIX Addendums: 


1. 
2. 


A fix to the kernel Direct I/O. 


A new version of iv(1M) that formats SCSI disks in the 
manufacturer’s defaults regardless of the disk description 
file. 


Changes to SCSI tape driver error handling, so that when 
a filemark is encountered and any recoverable errors 
occur, the driver does not miss the filemark. 
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4. 


es 


There is a new version of the kernel ST506 disk driver. It 
fixes a problem with Hitachi disk drives/by suppressing 
error reporting when the error W_ABC (Command 
Abort) is received. A retry then takes care of the actual 
disk transfer. 


2.5.3 Bugs Fixed in this Release 


The problems that have been fixed since 6.10 are listed below: 


1. 


SPR 15526: rmai(1C) is fixed. If rmad did not see a 
From_ line, uf was uninitialized but was referenced. If 
there is no From_ line, rmad now gets the From_ line 
from $LOGNAME. If LOGNAME is not set, rmad then 
tries getlogin({), then getpwuid(). 


mailt(1C) now works for sending mail to local users. 


The utility shutdown(1M) has been changed. It now tests 
for incorrect command name invocation at the start of the 
script and it checks whether there are at least 16 free 
blocks in / before continuing. Also upper case input is 
now handled correctly. 


If shutdown(1M) exits with a warning about lack of free 
space in root, it is necessary to remove insignificant files 
before continuing. It is wise to have more than 100 
blocks free, but 16 will suffice for shutdown to occur. 


2.5.4 Detailed Bug Fixes in System V Release 3.2 Kernel 
Detailed bug fixes in the System V Release 3.2 kernel: 


1. 


On a mount of an S51K file system, the updating of the u 
struct occurs after all error condition tests have been 
passed. 


The statfs system call on a S51K file system which is not 
mounted now checks to see if the device number in the 
inode struct is in range before trying to read in the 
superblock. 


When freeing storage from a specified inode in the S51K 
file system, the calculation of the index into the inode’s 
block list of the last block is now correctly calculated. 
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10. 


11. 


12. 


When getting directory entries from a S51K file system, 
the inode access time is now allowed to be updated. 


When obtaining a physical disk block number on a device 
given the inode and the logical block number in a file, 
there is a scan of the mount table to see if this block 
device is mounted. During this scan of the mount table, 
a check is now done to see if the size from the mount 
table (the source) is greater than the size in the inode 
struct (the destination). If it is not then ignore the 
mount table entry. 


When doing a clone open, CTIX now protects against 
another clone open on a different inode. 


When a STREAMS module gets popped off the stream 
and it’s not an ordinary release and it’s not a 
disconnection request, don’t send a disconnection request 
back up to the application. 


In the UNIX kernel STREAMS module read queue put 
procedure, if there is a message type of TERROR_ACK 
or T_OK_ACK, send an M_ERROR message back up to 
the application. 


When doing raw I/O, RFS now checks to see if the byte 
count requested is greater than NPGPT*NBPP. If so, 
then loop doing blocks of NPGPT*NBPP bytes until the 
requested byte count is satisfied. 


In the UNIX kernel idle loop, CTIX will now give higher 
priority to the STREAMS processing when there are no 
runnable processes [see swtch()]. 


The following STREAMS functions, are now protected 
from interrupts: 


freemsg(), dupb(), dupmsg(), copymsg(), linkb(), 
unlinkb(), rmvb(), 
flushq(), insq(), strinit(), noenable(), enableok(). 


When doing the steams functions pullupmsg{) and 
adjmsg({), CTIX will now protect against possible zero 
address references. 
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13. When doing a streams open call, the streams table is 
checked to make sure that there are not two streams to 
one device. This closes the timing window between 
opening and closing a stream. 


14. When doing a streams clean call, if the inode byte count 
and the request byte count passed to the clean routine are 
equal to one, then CTIX decrements the streams table 
entry’s reference count by one. This closes another timing 
window the between opening and closing of the last open 
of a stream. 


15. When doing a streams read call, if the FNDELAY flag is 
set then CTIX does not cause the streams read to fail 
when there is nothing available from the read queue. 


16. Now allow M_COPYIN and M_COPYOUT cases for 
STREAMS driver or module ioctl data within the UNIX 
kernel. 


17. CTIX does not allow an RFS link system call to be 
handled by the RFS server process. Symbolic links are 
not supported by RFS. 


18. The signal SIGWINCH has been integrated into signal 
processing. 


19. CTIX allows a null string from a just received block of 
data from the network in the name server process. 


20. A typedef bug in the network services library related to the 
connection ID was fixed. 


2.5.5 Bugs Fixed by the nce Compiler 


In 5.25.2 CTIX and in 6.10 CTIX, a new C compiler, nec, was 
introduced to fix a number of problems. This compiler was 
given a new Group, NCC. For the benefit of those who are 
updating from a 5.25.1 CTIX release, the compiler fixes are 
reiterated in this Release Notice. 


e SPR 2571: When compiled with the -g option, the compiler 
would sometimes take the size of a function, causing an 
*internal compiler error” message. 
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SPR 12819/13543: The compiler generated bad code for an 
expression which dereferenced a double array element. The 
generated code used a data register for two different 
purposes at the same time. 


SPR 10714: Compiler was generating a bfins instruction 
with the source operand in an address register, which is wy 
illegal. 


SPR 11638: The compiler generated a "cmp.w” instruction 


for a comparison involving byte variables. 


SPR 12134: The compiler generated bad code when using 
variables of type enum as array indexes, causing incorrect 
offsets. 


SPR 13039/12771: The compiler did not generate correct 
code for the following: 


char *foo(); return (foo()[i]); 


SPR 11763: The compiler would generate the following 
error message for some code segments: 


compiler error: cfix trouble” \wuw/ 


SPR. 12610: An error message was incorrectly generated for 
a shift involving a variable of type "enum”. 


SPR 12611: The following program generated the error 
compiler error: bad bigsize 012” on the cast: 


enum col { red, green, blue }; 
main() { 

char str[3]; 

enum col e = red; 


str[0] = (char) e; 


SPR 12648: The following code caused the compiler error, 
"can’t deal with op AUTO”: oy 


char x = (1 &&1) ? 1: 1; 
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e SPR 13065: The ’cc’ command used the wrong libraries 
when profiling is used even though LIBROOT and 
CENVIRON were correctly set. 


2.5.6 C Compiler Bugs Fixed in 6.10 CTIX 


A number of problems with the 5.25.1 CTIX C compiler were 
fixed in 6.10 CTIX. These were fixes to libraries that could not 
be back-ported to 5.XX CTIX due to source licensing 
restrictions. For the benefit of those who are updating from a 
5.XX CTIX release, the compiler fixes are listed in this Release 
Notice. 


e The compiler could not deal with complex expressions such 
as the following: 


int b, c, f; char *d; 
b? (c? (*d =0): f): e(); 


This expression caused an “internal compiler error” message. 


« The compiler generated a warning when an enum was used 
in a switch expression. 


e The optimizer could generate a jump subroutine with a data 
register as the address, which is illegal. This caused an 
assembler syntax error. 


e The compiler front end did not pick up an illegal use of a 
structure in an if expression. This caused an “internal 
compiler error” message. 


e The compiler front end did not pick up an illegal use of a 
structure in a conditional expression. This caused an 
internal compiler error” message. 


e The optimizer generated an incorrect short multiply 
instruction between an address and data register, causing an 
assembler syntax error. 


e« The compiler generated a cryptic error message for the 
following, incorrect code: 


int f(a); f(b) { a=b; } 
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The compiler incorrectly evaluated expressions of the form: 
if ((signed -= unsigned) < 0) 


The compiler removed this code, under the false assumption 
that the expression could not be less than zero. 


The compiler generated bad code for bit field comparisons 
in which the high bit of the field is set. 


The compiler would fail to compile an expression of the 
following form: 


double *a, *b, *c; *a = *b = *c; 


Some code segments exist which could make the optimizer 
go into an infinite loop. 


The compiler would generate bad code for the following: 


short a = -1; 
unsigned long ]; 
1 = ((unsigned short) a); 


The long variable contained -1, when it should have 
contained Oxffff. 


The compiler would generate incorrect code for float to 
unsigned conversions, double to unsigned conversions, 
unsigned to double conversions, and unsigned to float 
conversions, where the number being converted was beyond 
the range of a positive signed integer. 


Bit fields were sometimes improperly typed to a signed type 
rather than an unsigned type. Then, for a conditional test on 
a bitfield, code could be generated which would test the ’N’ 
(negative) bit of the condition code register. This was 
incorrect, since an unsigned type can never be negative. 


‘The 5.2X CTIX version (based on AT&T System V Release 
2.2) of the Section 3C library lacked the subroutines to 
manipulate the hardware Floating Point chip. 6.2 CTIX 
contains those routines: fpgetmask(3C) and fpsetmask($C). 
These routines should be used before relying on Floating 
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Point Exception detection, because they set the mask that 
controls output of the Exception from the Floating Point 
coprocessor. 


e Correct code which contained bit fields which were 32 bits 
a wide could cause the compiler to generate the following 
cryptic compiler message: 
Compiler Error: line 97: compiler error: sconv:t 05. 


e The compiler would not increment the register short pointer 
in the following example: 


proc() 
register short *p = val; 
fune( *p+ +); 
func2(p); /* any reference to p */ 
This problem occurs only with register short pointers; any 


o~ other combination of unsigned, or type length produced the 
proper code. 
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3. Contents of the Distribution Media 


The 6.2 S/Series CTIX distribution comprises 1 Quarter-Inch 
Tape: 


e Raw/Update Installation Tape (Part # 71-03352-01) 
3.1 Raw/Update Installation Tape 


The Raw/Update Installation Tape contains all the files 
necessary for either initial or update installation. Files 
numbered 5 and greater are cpio(1) archives in -Qc format. 


File # Description 
0 VHB and loader 
1 stand-alone UNIX kernel 
2 stand-alone file system (reserved area 1) 
3 minimum file system (reserved area 2) 
4 download images 
5 installation tools 
6 installation control files for CORE Group 
7 customizable files for CORE Group 
8 required files for CORE Group 
9 installation control files for ADMAN Group 
10 required files for ADMAN Group 
11 installation control files for LP Group 
12 required files for LP Group 
13 installation control files for UUCP Group 
14 customizable files for UUCP Group 
15 required files for UUCP Group 
16 installation control files for RIOP Group 
17 required files for RIOP Group 
18 installation control files for LAN Group 
19 required files for LAN Group 
20 installation control files for SYSM Group 
21 customizable files for SYSM Group 
22 required files for SYSM Group 
23 installation control files for ACCT Group 
24 customizable files for ACCT Group 
25 required files for ACCT Group 
26 installation control files for BCE Group 
27 required files for BCE Group 
28 installation control files for ACE Group 
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required files for ACE Group 

installation control files for DOC Group 
required files for DOC Group 

installation control files for KFIG Group 
required files for KFIG Group 

installation control files for GAMES Group 
required files for GAMES Group 
installation control files for TINFO Group 
required files for TINFO Group 
installation control files for HELP Group 
required files for HELP Group 

installation control files for ASSIST Group 
required files for ASSIST Group 
installation control files for CROSS Group 
optional files for CROSS Group 

required files for CROSS Group 
installation control files for MISC Group 
required files for MISC Group 

installation control files for SMAIL Group 
customizable files for SMAIL Group 
required files for SMAIL Group 
installation control files for NCC Group 
required files for NCC Group 


This release is structured to allow installation of one or more 
selected subsystems, or groups of commands. A_ brief 
description of each of the 20 groups follows. 


Group 


CORE 


Description 


required CTIX CORE commands. This group 
is mandatory and is treated specially in that the 
system is automatically rebooted upon instal- 
lation completion. 

Menu-oriented System Administration tools. 
Line Printer spooling system. 

UNIX system to UNIX system CoPy programs. 
Remote IOP system. 

Local Area Network protocol independent programs. 
SYStem Maintenance commands including sys- 
tem profiling and file system repair. 
ACCounTing system which reports CPU usage, 
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BCE 


ACE 


DOC 


KFIG 
GAMES 
TINFO 


HELP 
ASSIST 
CROSS 


MISC 
SMAIL 
NCC 


user disk usage, command usage and more. 
Basic ’C’ Environment, including the ’C’ 
compiler, loader, assembler, libraries. 

This suite is configured to generate code for a 
68020 CPU with software floating point. 
Advanced ’C’ Environment: SCCS, lex, yacc, 
awk, profiling, lint, etc. 

D OCumentation and text formatting tools: 
nroff, spell, terminal filters, fonts, etc. 
Kernel conFIGuration files and commands. 
CTIX GAMES. 

Terminal INFOrmation files in /usr/lib/ 
terminfo. 

The HELP sub-system. 

Screen oriented command interpreter. 
68020-68881 CROSS-development environment 
used to generate code for the 68881 floating 
point hardware on your own machine, 

if you have it; or to generate code 

for machines other than your own. 
MISCellaneous CTIX commands. 

Sendmail and associated support files. 

C compiler with several bug fixes. 
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To obtain an actual list of the contents of the cpio archives on 
the Raw/Update Installation Tape, execute: 


tsioctl -c rewind /dev/rmt0 
tsioctl -c skip /dev/rmt4 5 


while true 
do 
/bin/cpio -icvQt < /dev/rmt4 
if{ $? = 2 | 
then 
break 
fi 


done 
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3.2 Maintenance Mode 


The 6.2 S/Series CTIX Raw/Update Installation tape provides 
the maintenance tape function of previous releases. 
Maintenance mode is entered by choosing the maintenance 
option when the install tape is booted. 
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4, Installation Requirements 

4.1 Time Required for a Full Installation 

The installation of all Groups will take about thirty minutes. 
4,2 Files Required for an Update Installation 


There are no required files to perform an update installation. 
The installation tape is completely self contained. 


Note that the installation renames each file in /etc/rcopts to 
"OLD filename’ before it loads new files into /ete/rcopts. Save 
your customizations and apply them to the new files. 


When updating from 5.25 or 6.10 CTIX, you will see an error 
message about make(1) not knowing how to make instclobber. 
Ignore the message. 


4.3 Space Required for an Update Installation 


Installation of the CORE Group requires approximately 2048 
free blocks on the root file system at the time of installation 
script invocation. The command: 


af / 


reports the number of free blocks on the root file system. If 
there are not 2048 free blocks, clean up the file system to 
obtain them before executing the installation script. This space 
is required to save necessary files and to read in the 
customizable files. 


4.4 Space Required for each GROUP 


The entire 6.2 CTIX release uses 53600 512-byte disk blocks; 
20800 of which are in /, and 32800 of which are in /usr. The 


number of blocks and inodes each Group uses is tabulated 
here: 
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root rootinodes usr usrinodes total 


180 10770 

161 5234 

75 738 

86 1492 

0 376 
814 ad 

2168 

458 

5926 

4686 

2554 

2490 

1194 

2208 

856 

2376 

7022 


318 
954 
TOTAL 20822 1529 32698 2775 _ 53520 


— 


Installing all groups leaves very little free space in the root and 
usr (if separate) filesystems. An easy way to save some of the 
space in the root filesystem is to separately mount /cross before 
installing the CROSS Group. 


The groups can be clustered together into several categories: 


Basic: CORE ADMAN LP TINFO MISC 
necessary for minimal system operation 


Network: UUCP LAN SMAIL (1) 


required for electronic mail 


SGS: BCE ACE CROSS (2) 
required for software development 


Sysadm: SYSM ACCT HELP KFIG (3) 
useful for system administration 
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Option: RIOP 
required for RIOP support 


Mise: GAMES ASSIST 
miscellaneous software groups 


ron 
There are some dependencies, indicated by the numbers: 
1. SMAIL expects that UUCP has been installed. 
2. BCE must be installed before ACE, CROSS, or NCC. 
3. KFIG depends on BCE being installed. 
oo™ 
| 
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5. Installation Procedures 


If your system has 5.XX CTIX installed, be aware that system 
initialization has changed (new scripts, directories, etc). If you 
are doing an update instead of a raw install, learn the 
differences before proceeding. Refer to the man pages for 
rcO0(1M), re2(1M), and re8(1M), in the CTIX Operating System 
Manual, Version C. In order to get the new ctinstall(1), use the 
5.XX OTIX installation procedure: 


tsioctl -c skip /dev/rmtA 5 
cpio -icvQdum install /ctinstall < /dev/rmt0 
/install/ctinstall 


There are three modes of installation described here: Raw, 
Update, Update Silent Mode. These correspond to the 
ctinstall(1) options install, update and update in silent mode, 
respectively. 


Do not attempt to update CORE using update from single 
user level. 


e If your disk does not already have a running CTIX system 
on it, perform a raw install. 


e If your system is already running CTIX, you may perform 
an update install. 


e If your system is already running CTIX and it is acceptable 
that all existing customizable files (such as /etc/passwd) are 
renamed to OLD <filename> and replaced with the release 
versions, then perform an update in silent mode, which 
does not ask you many questions. 


WARNING: If your installation fails during the CORE Group, 
the file /etc/inittab has been removed and the /usr file system 
may not be mounted properly. To correct this situation, do the 
following: 


1. Execute umount /usr 


2. Create /etc/inittab and /etc/mnttab, by executing > 
/ete/inittab ; > /etc/mnttab 
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ae 


3. Execute rm -rf /install/bin 
4. Reboot. 


If your installation fails for some reason, do not use the restart 
capability of ctinstall(/1). restart cannot handle all cases of 
install failure and your root file system might end up in a 
strange state. Instead, fix the problem that caused the failure 
and start the entire installation over again. 


A list of installed files does not appear on the screen. 


Remember that the new loader has size greater than 30K and 
that the new disk description files have been changed to reserve 
128K for the loader in the system disk slice 0. 


Changing to a single binary tape for all S/Series systems has 
required providing all files for each type of specific machine. 
For some machine types, not all provided files are needed and 
can be removed to gain some disk space. The following files 
are among this group: 


1. For the S/80 and S/280, there is no RS-422 cluster line 
support, so the files /usr/lib/iv/ws* may be removed. 


2. For the same reason, the RIOP Group should not be 
installed. Use the ctinstall(1) omit mode for installation 
of groups. 


If you should respond to the prompt for Group selection with 
only RETURN’s or with incorrect responses, which causes 
ctinstall(1) to prompt again for selection, the list of Groups 
selected will end up having multiple entries for some or all 
Groups. ctinstall(1) goes through the list and discards multiple 
instances of each Group it installs. 


5.1 Raw Installation 
5.1.1 Overview 


6.2 S/Series CTIX can be installed on ST506, SCSI, or SMD 
based systems. (Note: SMD disks are only supported on 
systems which have a VME bus.) Northern Telecom SMD 
disks are supported. Installation on SMD disks requires several 
preliminary steps. 
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Note: Raw installation initializes the system disk, and you will 
be able to change the disk configuration (number and size of 
partitions, separate /usr partition, etc). The installation does 
not check the current disk partitioning. You must use the 
default disk description file parameters supplied with the release 
or you must request modification. If necessary, make note of 
your current disk configuration using iv -t. The drive should 
be formatted and have a valid bad block table and Volume 
Home Block. 


If you plan to install and use TCP/IP and RFS or NFS, you 
should not use the default sizes. Use the following sizes 
instead: 


Partition Logical Physical 
1024-byte blocks 512-byte blocks 

slice 1 17600 35200 

slice 2 8000 16000 

slice 3 24000 48000 


Otherwise you must omit some groups, in order to have 
enough space. 


Note that to boot off an SMD disk requires a boot PROM with 
a revision level of 1.2 or above. Also note that for S/640 
machines to boot off the SCSI disk (onboard SCSI bus only) 
requires a boot PROM with a revision level of 3.0 or above. 


The loader attempts to boot off the following devices in order: 
1. Quarter-inch tape 


2. ST506 disk 
3. SMD disk 
4. SCSI disk 


Please refer to the Section "Initializing and Configuring Disks” in 
Chapter 8, "Disks and File Systems”, of the S/Series CTIX 
Admunistrator’s Guide if you want to add disks other than those 
shipped with the system. 
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5.1.2 Preparation for Raw Installation on SMD Disks 


If your system does not have SMD disks or you are not 
installing on an SMD disk, you may skip this section. Before 
6.2 S/Series CTIX can be installed for the very first time on an 
SMD disk, the following preparatory steps must be performed. 


1. 


Go into maintenance mode after booting from the tape. 
Refer to Section 6, "Using Maintenance Mode” for a 
description of the Maintenance Mode. 


Skip this step if the SMD controller is already at address 
C1000200. Edit the ramdisk file /etc/system if you want 
to place the SMD controller at an address other than 
C1000200. Remove the loadvs32 field. (On the 
controller board itself, address C1000200 corresponds to 
base address switch 1 off and all others on.) 


Execute the. ldeeprom(1M) command to load _ the 
electrically erasable programmable read-only memory on 
the VME interface card. This command might take up to 
10 minutes to complete. 


Execute the hardware inventory command 
hinv -p 


to verify that controller number 1 exists and has your 
drive on it. 


Installation of 6.2 CTIX requires a valid Volume Home 
Block in slice 0 of the disk drive. Execute 


iv -t /dev/rdsk/cld0s0 


to determine the validity of the Volume Home Block on 
SMD drive 0. If the drive does not contain a valid 
Volume Home Block, you will get an error message about 
not being able to access the drive. You must format the 
drive with a Diagnostics tape or contact your Convergent 
Technologies Field Service Representative. 


Having verified that a valid Volume Home Block exists on 
the drive, reboot the tape and continue with the Raw 
Installation steps outlined below. 
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Optional: if your machine has an existing CTIX on an 
ST506 system disk and you are switching to an SMD 
system disk, you may want to save any important files 
from the file systems on the ST-506 disk then re-initialize 
it. 


5.1.3 Raw Installation Process 


To raw install 6.2 CTIX perform the following steps. 


WARNING: THIS PROCEDURE DESTROYS ALL 
EXISTING DATA ON THE DISK. 


(If you do not have an SMD controller, ignore any messages 
about its absence.) 


1. 


The raw installation requires an RS-232 terminal at 9600 
baud on channel 0 or an RS-422 terminal on cluster line 0 
(with no RS-232 terminal connected to channel 0). 


Insert the distribution Quarter-Inch Tape into the drive 
and close the latch. 


If the system is not powered on then turn power on, 
otherwise open the access door on the S/Series enclosure 
and press the reset button. 


WARNING: The sizes of disk partitions must be even 
multiples of 32, in order to create partition starting block 
numbers that are. on disk track boundaries. This is the 
simplest means of satisfying all disk type (ST506, SMD, 
and SCSI) requirements. 


The following output appears on the screen. User 
supplied responses are shown in boldface type. A carriage 
return is implied after every user input. The example 
presented here is taken from an-SMD disk installation on 
a system having both SMD and ST506 disks. The 
corresponding ST506 or SCSI messages appears for their 
respective installations. 
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HAAR AKA KR RK HK RK RK RK KK RK AK RAE RACK ERE IR RE RE RK I IK 


WELCOME TO CTIX 


This is the software raw-install/update tape 
It includes the maintenance file system. 


install’ should be used ONLY for new systems 
IT WILL OVERWRITE AND DESTROY THE ENTIRE 
CONTENTS OF YOUR DISK DRIVE 


’update’ should be used to upgrade CTIX 
without destroying contents of your disk 


*maintenance’ will give you access to the 
maintenance file system 


* * * * * He Ke Ke He HH HN HH HR KH KH ¥ 


* * ¥ HF He He HH KH BH HE HH KF 


FE A A A A A AK A KK RA AR KK EK IK RR KK KR KK IK A OR OK EK EK CK OR KK a aK 


Do you wish to install, update, or do maintenance? 
Choices are (’install’, ’update’ or maintenance’)? install 


You have both an onboard ST506 drive 0, and a SMD drive 0. 


Do you wish to install on the SMD instead of the ST506? 
Type ’yes’ to confirm/continue: yes 


You have selected install which will 

Erase The Entire Contents of your disk 
Do you wish to continue and install the CTIX software on 
SMD drive 0? 


Type ’yes’ to confirm /continue: yes 


Do you wish to modify the standard boot disk configuration? 
Type ’yes’ to confirm/continue: yes 


NOTE: The Install gives you the default boot disk 
configuration if you answer ’no’ to this question. The 
default configuration sets the following partition sizes: 
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Partition 1 12000 /root 
2 6000 swap 
3 _ 16000 


Partition 1 16000 /root 
2 8000 swap 
3 20000 


CTIX is growing larger than 40MB disks can 
comfortably support. It is still possible to operate with 
such a disk, but you must choose carefully which groups 
to install. If you are unsure of what to choose for a 
40MB disk install, consult with S/Series Technical 
Support. 


If you answer ’no’ to this question skip to the next 
section. 


If you answer ’yes’ the installation continues: 


You have N megabytes of dump area 
Do you wish to change this number? 
Type ’yes’ to confirm /continue: yes 


Enter size in megabytes: O 


NOTE: The dump area on the disk is used to contain what 
was in memory at the time of a system crash. In most 
cases you do not need this area. However if you are 
writing device drivers or other operating system functions, 
you might want one. If you do, you need a megabyte of 
dump area for every megabyte of physical memory that is 
in your system. This also may be set to ’0’ for no dump 
area. 


NOTE: Slice 2 will be used as SWAP device! 
Default for slice one will be 2000 less than total 
available blocks to allow for minimum swap slice! 
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Enter new slice sizes 
slice 1: (default—NNNNNN) NNNNNN 


NOTE: The installation does not allow the first slice (slice 
1) of the root disk to be under a size that can contain the 
CORE Group of the OS release. It also does not allow 
you to have a swap slice of less than 2000 blocks. If you 
want a separate /usr file system you need to configure for 
at least 3 slices with the third slice being used for the /usr 
file system. (You can configure for three or more slices 
and still choose not to have a separate /usr file system.) 
Just pressing <RETURN> ends the input and continues 
to the next question. Example: 


slice 1: (default=90000) 16000 

slice 2: (default74000) 8000 

slice 3: (default—66000) 24000 

slice 4: (default—42000) <RETURN> 


Are these partition sizes satisfactory? 
Type ’yes’ to confirm/continue: yes 


NOTE: You see this next question only if you configured 
for 3 or more slices! 


Do you want /usr to be mountable on Partition 3? 
Type ’yes’ to confirm/continue: yes 


The installation continues: 


The Bad Block Table contains NN entries 
SMD disk drive #0 is setup 
>> >Adding a swap area 


path dev  swaplo blocks free 
/dev/dsk/cld0s2 1,2 0 NNNNN NNNNN 


>> >Root file system made.” 

>> >Usr file system made.” 

mount: warning: <> mounted as </mnt> 
>> >Root file system mounted.” 
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10. 


>> >Usr file system mounted.” 


The installation proceeds by loading the programs 
essential to the installation. 


Loading in minimum installation file system 
NNNNN blocks 


Loading in installation tools 
NNNNN blocks 


The ctinstall(/1} command is now executed from the raw 
install script: 


ctinstall.sh 6.32 


Positioning the Tape for Product Installation. 


The ctinstall script asks for user-input at this point. The 
usual response in a raw install is all’. (Refer to the 
section on "Some Notes about Cross Development” for 
information on the CROSS Group). 


CORE ADMAN LP UUCP RIOP LAN SYSM ACCT BCE ACE DOC 
KFIG GAMES TINFO HELP ASSIST CROSS MISC SMAIL NCC 


Please enter your group choices for CTIX 


If you’d like all of the groups, type ’all’; 

If you’d like none of the groups, type ’none’ 

If you’d like to omit some groups, type ’omit’ 
followed by groups to omit: all 


Since you are installing CORE the installation continues 
with: 


Starting to Install Group(s) CORE ADMAN LP UUCP RIOP 
LAN SYSM ACCT BCE ACE DOC KFIG GAMES TINFO HELP 
ASSIST CROSS MISC SMAIL NCC into /. 

Installing Group CORE. 
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11. 


12. 


The space required for the new files is determined and the 
changes reported. 


Calculating size required for group CORE. 


NNN 512 byte blocks will be freed on / 
NN additional inodes will be used on / 
NNN 512 byte blocks will be used on /usr 
NN additional inodes will be used on /usr. 


Reading Customizable CORE files. 
Installing Customizable CORE files. 
NNNNN blocks 


CORE Customizable files installed. 


Installing required CORE files. 
NNNNN blocks 


Creating 0 length files. 
Checking permissions and modes on new CORE commands. 
Completed Installation of Group CORE. 
CORE installation cleanup ... 


{Other groups selected will now be installed.] 
Rewinding tape. 


Installation Complete. 


When the installation has completed, the installation 
script prompts: 

Group ACCT has been installed. Do you want Accounting 
enabled? 

Type ’yes’ to confirm: answer 


Group LP has been installed. Do you want the LP spooler 
enabled? 


Type ’yes’ to confirm: answer 


What do you want the NODE name of the system to be? 
answer 
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Group SAR has been installed. Do you want system activity 
reporting enabled? 

Type ’yes’ to confirm: answer 

Remove the tape and press return (the system will reboot): 


13. After pressing RETURN, the system reboots. Installation 
is complete. 


5.2 Update Installation 


To update an existing CTIX system to 6.2 CTIX perform the 
following steps: 


1. Log in as root. Provide a password if necessary. The 
system will respond with a # prompt. 


2. ed / RETURN 
3. Bring the system into single-user mode by entering: 


/ete/shutdown RETURN 


Before installing the product wait for the system to 
prompt with the message: 


Ok To Stop Or Reset Processor 


4. Insert the distribution Quarter-Inch Tape into the drive 
and close the latch. 


5. Reboot the system with the following commands: 


syne ; reboot RETURN 


6. The following output appears on the screen. User 
supplied responses are shown in boldface type; a carriage 
return is implied after every user input. The example 
presented here is taken from an SMD disk installation on 
a system having both SMD and ST506 disks. 
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SRA ACK IIR KR AR KK HK KK RA RK AK KK CK KR RR RR OR OR KK 


WELCOME TO CTIX 


This is the software raw-install/update tape 
It includes the maintenance file system. 


install’ should be used ONLY for new systems 
IT WILL OVERWRITE AND DESTROY THE ENTIRE 
CONTENTS OF YOUR DISK DRIVE 


’update’ should be used to upgrade CTIX 
without destroying contents of your disk 


*maintenance’ will give you access to the 
maintenance file system 


* * & &F # & F HF HK HF HF KF KH KH KH 


* %* © & * *¥ * KF KF KH KR HR KH KR KH K 


SRA HR AK AK AR AK AR EK A RK RK KKK RK IR A RK CR IR CR KC RE KK AK KK 


Do you wish to install, update, or do maintenance? 
Choices are (’install’, ’update’ or ’maintenance’)? update 


Do you want this to be a silent update? 

Silent update uses fewer prompts and saves customizable files 
as OLD filename’ 

Type ’yes’ to confirm or ’no’ to deny: no 


You have both an onboard ST506 drive 0, and a SMD drive 0. 


Do you wish to update on the SMD instead of the ST506? 
Type ’yes’ to confirm/continue: yes 


BE SURE YOU BACK UP ANYTHING YOU HAVE 
CHANGED BEFORE PROCEEDING. 


Do you wish to continue and update the CTIX software 
on SMD drive 0? Type ’yes’ to confirm/continue: yes 
The installation continues: 


>>> Doing an UPDATE installation <<< 
Adding a swap area 
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path dev  swaplo blocks free 
/dev/dsk/cld0s2 1,2 0 16000 16000 


running fsck on root file system 
File System: Volume: 


*k Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

#* Phase 3 - Check Connectivity 

*k Phase 4 - Check Reference Counts 

** Phase 5 - Check Free List and Bitmap 
FS STATE SET TO OK 

NNNN files NNNNN blocks NNNN free 


Mounting root file system 
mount: warning: <> mounted as </mnt> 


If /usr is a mounted file system then fsck is run and /usr 
mounted. 


running fsck on /usr file system 
File System:usr Volume:usr 


** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

*k Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Free List and Bitmap 
NNNN files NNNNN blocks NNNN free 


Mounting /usr file system 

[It is important to fix any problems before continuing.| 
The installation proceeds by loading the programs 
essential to the installation. 

Loading in minimum installation file system 

NNNNNN blocks 

Loading in installation tools NNNNNN blocks 
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il. 


12. 


13. 


The céinstall(1) command is now executed from the raw 
install script: 


ctinstall.sh 6.32 


Positioning the Tape for Product Installation. 


The ctinstall script asks for user-input at this point. The 
usual response in an update installation is ’all’; however, 
the only required choice is "CORE’. If you have already 
installed CORE and want to update other groups, refer to 
section 5.4 of this release notice. Refer to Section 10.10 
of this release notice for information on the CROSS 
Group. 


CORE ADMAN LP UUCP RIOP LAN SYSM ACCT BCE ACE DOC 
KFIG GAMES TINFO HELP ASSIST CROSS MISC SMAIL NCC 
Please enter your group choices for CTIX 


If you’d like all of the groups, type ’all’; 

If you’d like none of the groups, type ’none’ 
If you’d like to omit some groups, type ’omit’ 
followed by groups to omit: CORE 


Since you are installing CORE the installation continues 
with: 


Files in the following directory are being removed: 


/usr/sys - Install the KFIG group for the new kernel 
libraries and build tools 


(Several files in /usr/sys are mentioned as being removed. 
If you are updating from 5.XX or 6.10 CTIX, ignore a 
message about ”instclobber”.) 


Removing files that no longer exist or are being moved 
/etc/bcheckre is no longer customizable, 

see /etc/rcopts/README 

/ete/bcheckre moved to /etec/OLD bcheckrc 

/etc/profile is no longer customizable, 


see /etc/rcopts/README 
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15. 


16. 


14. 


/ete/profile moved to /etc/OLD profile 
/etc/cprofile is no longer customizable, 
see /etc/rcopts/README 

/etc/cprofile moved to /ete/OLD cprofile 


The installation continues with: 


This procedure will update the / file system with 
6.2 CTIX group(s) 


XXX 
Type ’yes’ to confirm/continue: yes 


Starting to Install Group(s) XXX into /. 

Installing Group XXX. 

The space required for the new files is determined and the 
changes are reported. 


Calculating size required for group XXX. 


NNN 512 byte blocks will be freed on / 
NN additional inodes will be used on / 
NNN 512 byte blocks will be used on /usr 
NN additional inodes will be used on /usr. 


Reading Customizable XXX files. 


Installing Customizable XXX files. 


You are then queried, for each customizable file, as to 
whether you would like to: 


r| replace the old one with the new 


s] save the old one in OLDfile and replace with the new 


[ 

[ 

[i] ignore the new one 

[d] perform an sdiff(1) between the old one and the new 
[ 


rd] replace the old one with the previous diff. 


If you do not want to destroy an old version, save the old 
one and replace with the new. Then, after the installation 
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17. 


18. 


19. 


20. 
21. 


22. 


is complete, compare the two and update the new one 
with your changes. 


The installation continues: 
XXX Customizable files installed. 


Installing required XXX files. 
NNNNNN blocks 


Creating 0 length files. 

Checking permissions and modes on new XXX commands. 
Completed Installation of Group XXX. 

XXX installation cleanup 


[Other groups selected are installed also.] 
Rewinding tape. 


Installation Complete. 


When the installation has completed, the installation 
script prompts: 


Remove the tape and press return (the system will reboot): 


After pressing RETURN, the system reboots. Installation 
is complete. 


If CORE is installed, the "CORE installation cleanup” 
runs iv(1M) to install a new loader and download files. 


If CROSS is one of the groups chosen to be updated, 
decide which cross development libraries, if any, are to be 
installed. If your machine has floating point hardware, 
decide whether to install 2fp in the root file system 
replacing the default 2sw libraries. If 2fp is installed in 
the root file system, it is removed later from /cross. The 
following messages appears on the screen: 


Querying Optional CROSS files. 


The cross development libraries available for installation 
are: 
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23. 


24. 


25. 


26. 


27. 


68020 with software floating point (2sw) 
68020 with 68881 hardware floating point (2fp) 


If the machine has software floating point, the installation 
script echos: 


This 68020 machine has software floating point. 


If the machine has hardware floating point, the script 
echos: 


This 68020 machine has a 68881 chip (hardware floating 
point). 


Type ’y’ if you’d like to install 2fp into the ROOT file 
system: y ; 


Changing CENVIRON in /etc/profile to 
CENVIRON=”CPU =68020,FPU—68881” 


The installation continues: 


Please enter your choices separated by blanks. 
Possible choices are: 


all none 2sw 2fp 


Please enter ’all’ for both; ’none’ for none; or, 
any combination of ’2sw 2fp’ separated by blanks: all 


If CORE was one of the updated groups, upon 
completion the installation script prompts: 


Remove the tape and press return (the system will reboot): 


Installation is complete. 


5.3 Update Silent Mode Installation 


To non-interactively update your system, follow these 
instructions. 
1. Perform steps 1 through 5 listed in Section 5.2, "Update 


Installation”, above. 
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2. Step 6 listed in Section 5.2, "Update Installation”, is 
essentially the same except that when selecting the 
installation option, specify silent instead of update. 


Do you wish to install, update, or do maintenance? 
Choices are ( install’, update’ or maintenance’)? update 


Do you want this to be a silent update? 

Silent update uses fewer prompts and saves customizable 
files as ?OLD filename’ 

Type ’yes’ to confirm or ’no’ to deny: yes 


3. The installation proceeds very much as in Section 5.2, 
"Update Installation”, except that no questions are asked 
by the installation script, with the exception of: 


1. Which groups do you want to install? 


2. Then at the end some questions regarding options. 


Each old customizable file is saved in OLDfile and 
teplaced with the new file. After the installation is 
complete you may wish to compare your old customizable 
files with the newly installed ones and update the new 
ones with your customizations. 


5.4 Non-CORE Update Installation 


The procedures outlined above for RAW installation, update, 
and update silent mode installation are those required to install 
the CORE Group, normally the additional groups that are 
required would be installed as part of that process. However if 
you want to install some groups later, after installing CORE (it 
is essential that CORE is the first group installed from a set of 
release tapes), the following procedure can be used: 


1. Log in as root. Provide a password if necessary. The 
system responds with a # prompt. 


2. ed / RETURN 


3. Bring the system into single-user mode by entering: 


/ete/shutdown RETURN 
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10. 


Before installing the product wait for the system to 
prompt with the message: 


Ok To Stop Or Reset Processor 


Re-mount /usr if it is a mounted file system: 


/ete/mount /usr for 6.XX CTIX 


Insert the distribution Quarter-Inch Tape into the drive 
and close the latch. 


Rewind the tape with the following command: 


tsioctl -c rewind /dev/rmtO RETURN 


Execute the installation script: 


ctinstall RETURN 


The following output appears on the screen. User 
supplied responses are shown in boldface type; a carriage 
return is implied after every user input. 


ctinstall.sh 6.32 


Positioning the tape for Product Installation 


The ctinstall script asks for user-input at this point. You 
should not select CORE, because ctinstall will not allow a 
CORE install without booting from the tape. (Refer to 
Section 10.10 of this release notice for information on the 
CROSS Group). 


Please enter your group choices for CTIX separated by blanks. 


Your choices are: 


CORE ADMAN LP UUCP RIOP LAN SYSM ACCT BCE ACE DOC 
KFIG GAMES TINFO HELP ASSIST CROSS MISC SMAIL NCC 


If you’d like all of the groups, type ’all’; 
if you’d like none of the groups, type ’none’: << X > 


Further output is similar to that described in section 5.2, 
steps 14 through 25. 
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6. Using Maintenance Mode 
The 6.2 S/Series CTIX Raw/Update Installation tape contains 


the maintenance mode capability of previous releases. 


maintenance mode allows you to: 


1. boot CTIX 


The 


2. use provided tools to determine the cause of the problem 


3. fix the problem. 


Below are some examples of problems: 


1. When you are locked out of the system (for example, 
because you have forgotten root’s password and you 
cannot modify /ete/passwd without being root), 


2. Loading the VME Interface Board EEPROM. 


A partial list of the files available in maintenance mode follows. 


/bin/cat 

/bin/cp 

/bin /Is 

/bin/rm 

/bin /syne 

/dev/vme/a24 

/dev/vme/eeprom 

/dev/dsk/c0d2s[ 1-f] 

/dev/dsk/c1d2s| 1-f] 

/dev /dsk /c2d2s{ 1-f] 

/dev /rdsk /c0d2s[0-f] 

/dev/rdsk/c1d2s[0-f] 

/dev /rdsk/c2d2s[0-f] 
/dev/null 
/dev/rmtA 

/dev /tty 

/etc/icode 

/etc/mkfs 
/etc/passwd 

/etc/swap 

/ete/ldeeprom 
shlib/libc2sw_s 


/bin/chmod 

/bin/ed 

/bin/mv 

/bin/sh 
/dev/console 
/dev/vme/a321 
/dev/dsk/cOd0s{0-f] 
/dev/dsk/cid0s{ 1-f] 
/dev/dsk/c2d0s[ 1-f] 
/dev /rdsk/cOd0s[0-f] 
/dev/rdsk/c1d0s[0-f] 
/dev/rdsk/c2d0s[0-f] 
/dev/kmem 
/dev/prf 

/dev /tty000 
/ete/fsck 
/etc/icodel 
/etc/mnttab 
/ete/reboot 
/etc/umount 
/ete/hinv 
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/bin/cpio 

/bin /In 

/bin/mkdir 
/bin/stty 
/dev/vme/al6 
/dev/vme/a32h 
/dev/dsk/c0d1s[0-f] 
/dev/dsk/cld1s[1-f] 
/dev/dsk/c2d1s|1-f] 
/dev /rdsk/cOd1s|0-f} 
/dev/rdsk/c1d1s[0-f] 
/dev/rdsk/c2d1s| 0-f] 
/dev/mem 
/dev/tmt0 

/dev /tty256 
/ete/fsdb 

/ete/iv 

/etc/mount 
/etc/splocate 
/etc/system 
/ete/iv.desc.cpio 


Note: Access to the maintenance mode should be restricted, 
since it poses an obvious security risk. 


The number of files that can be included in the ramdisk file 
system is limited by the space needed for the kernel, a user 
area in which to run processes, and the files in the 
maintenance file system. The maximum space is limited by the 
minimum physical memory available on any one of the S/Series 
machines: 2MB. For this reason, many files, such as the loader 
/usr/lib/iv/loader, are not included. 


If you need the loader, in order to initialize the system disk, 
you must use one of several means: 


1. Remove some files from the ramdisk files system and use 
cpio(1) to bring in the loader from another 6.2 CTIX 
system to /usr/lib/iv. 


2. Mount the system disk /usr file system (if possible) on 
/mnt and copy /mnt/usr/lib/iv/loader to /usr/lib/iv. 
Unmount the /usr file system before doing the 7/1). 


3. Perform an install of the CORE Group. 


The file /etc/iv.desc.cpio is a cpio(1) archive containing 
minimally, the following files: 


/usr/lib/iv/desc.40PS /usr/lib/iv/desc.80PS 
/usr/lib/iv/desc.851 —/usr/lib/iv/desc.85M 
/usr/lib/iv/desc.85S —_/usr/lib/iv/desc.80QS 
/usr/lib/iv/desc.140M /usr/lib/iv/desc.140MS 
/usr/lib/iv/desc.190M /usr/lib/iv/desc.300N 
/usr/lib/iv/desc.350MS /usr/lib/iv/desc.650MS 
/usr/lib/iv/desc.750N 

/usr/lib/iv/desc.tape _/usr/lib/iv/desc.tdump 


If you need to use one of these files, it must first be extracted 
from the archive. Note that the desc files do not have entries 
for the dump area and the download images. You must edit 
the desc files if you want to add them. 


cpio -iv dese. XXXXX < _ /etc/iv.dese.cpio 
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In maintenance mode the following table describes 
controller to controller-type configuration (again note that S 
means S/80 and S/280, S/320 means S/120, S/22X, and S/320, 
and S/640 means S/480 and S/640): 


controller S/80 $/320 S/640 
none ST506 ST506 


none SMD SMD 
SCSI none SCSI 


Please refer to "Using the Maintenance Tape” in Chapter 13 of 
the S/Series CTIX Administrator’s Guide for complete 
instructions. 


Warnings: 


1. When accessing the Quarter-Inch Tape drive, use the 
device nodes /dev/rmtO and /dev/rmt4. These are linked 
at tape bootup time to the device nodes in /dev/rmt that 
correspond to your machine type. The device nodes 
/dev/rmt/cOdO and /dev/rmt/cOd0n are used for the 
QIC-2 drive of the $/320 systems and have major device 
numbers 18. The other device nodes in the directory 
/dev/rmt are used for the SCSI Quarter-Inch Tape drive 
of onboard SCSI-based systems and have major device 
numbers 65. 


2. If you enter a <CTRL>D to the maintenance mode shell 
the stand-alone kernel will panic. The maintenance mode 
init exec’s the shell. <CTRL>D kills the shell, and then 
there are no processes, a fatal condition. 
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7. Deleting a Group of Files from the System 


WARNING: DO NOT REMOVE THE CORE GROUP. 
Do not remove the BCE and KFIG groups if you need to 
reconfigure your kernel. 


To delete a group of CTIX release files from your system, 
follow these directions. Groups that can be deleted are: 


ADMAN LP UUCP RIOP LAN SYSM ACCT BCE ACE DOC KFIG 
GAMES TINFO HELP ASSIST CROSS MISC SMAIL NCC 


1. Insert the distribution Quarter-Inch Tape into the drive 
and close the latch. 


2. Make sure the tape is rewound by typing 


tsioctl -c rewind /dev/rmtO RETURN 


3. Skip to the installation control files for the group you 
want to delete. To do this, type 


tsioctl -c skip /dev/rmt4 [arg] RETURN 
where arg is the File # listed in Section 3.1 of this release 
notice. 

4. ed / RETURN 


5. Extract the installation control files for the group. 


cpio -iveQdum < /dev/rmtO RETURN 
6. Do an Is(1) to see which file lists exist for this group. 


Is GROUP* RETURN 
7. Remove the files in this group. 


cat [GROUP_file_lists] | xargs rm -f RETURN 
where GROUP _file_lists can be one of the files: 


GROUP, GROUP.cust, GROUP.noup, GROUP.noqu 
GROUP fopt 
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8. Remove the file-list files. 


rm GROUP* RETURN 
o™ For example, to delete the GAMES Group from the system, 
execute: 
tsioctl -c rewind /dev/rmtO RETURN 
tsioctl -c skip /dev/rmt4 34 RETURN 
ed / RETURN 
cpio -iveQdum < /dev/rmtO RETURN 
cat GAMES | xargs rm -f RETURN 
rm GAMES* RETURN 


Note that if you are removing the SMAIL Group, you must 
also perform the following: 


my /bin/OLDrmail /bin/rmail 
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8. Reconfiguring the System for More or Fewer Users 


As distributed, 6.2 S/Series CTIX is a 16 user system. The size 
of the proc table and the in-core inode table have been fixed to 
support 16 users. You can reconfigure your system for a 
number of users different from the 6.2 CTIX release default. 
If you intend to increase the number of users to the system 
limit, consult with S/Series Technical Support for the correct 
number of maximum users for your system configuration. 
Pushing your system above the limits might produce a 
configuration unsupportable by CITX. If you never have 
more than 8 users on your system at a time, you might 
reconfigure for 8 users. This would maximize available user 
memory. (Refer to Appendices B and C in the S/Series CTIX 
Admumustrator’s Guide for information about which 
configuration parameters are affected by the number of users 
specified). 


1. Login as root. 


2. Change the entries in /etc/inittab for gettys required. 
Refer to Chapter 5 and Appendix B in the Series CTIX 
Administrator’s Guide for instructions on how to configure 
/ete/inittab. 


3. Change the kernel parameter v_proc, using uconf(1M), or 
make the change in your version of dfile and rebuild the 
kernel. 


4. Reboot the system. 


The nominal upper bounds on the systems in the S/Series are: 


System Upper bound on maximum users 
5/80 16 
5/280 22 
§/221 32 
§/222 32 
$/320 32 
$/480 48 
S/640 64 
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NOTES: 
1. The utility muser{1M) has been discontinued. 


2. The output from hinv -u or hinv -p will now show a 
value of 128 maxusers for all S/Series machines. This 
value is meaningless to the user and should no longer be 
used in scripts that attempt to calculate the maximum 
users set for the system. The -u option of hinv{1M) will 
be discontinued in future releases. 
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9. The SCSI Subsystem 
9.1 S/Series SCSI Hardware 


The S/Series machines provide the capability of attaching SCSI 
devices to the system: 


1. Through a SCSI bus on the SCSI/RS-232 Expansion 
board for the S/320 systems. 


2. Through either an onboard SCSI bus, or a SCSI bus on 
the SCSI/RS-232 Expansion board for the S/640 systems. 


3. Through the onboard SCSI bus for the S/80 systems. 


The Western Digital chip WD3393 is the SCSI bus interface 
controller. Together with the CPU, this handles all necessary 
bus interface and SCSI protocol communication with other 
SCSI devices. SCSI devices can be connected to the internal 
SCSI bus, or connected to the SCSI bus through an external 
SCSI adaptor. For the S/80 and S/280 this can also be done 
using the connector on the SCSI/Ethernet board. 


Refer to your SCSI Hardware Reference manuals for controller 
and peripheral configuration details. 


9.2 S/Series SCSI Software 


There are three drivers in the system to provide the necessary 
software to interface to the SOSI hardware. When the kernel is 
configured, the corresponding entries have to be present in the 
system configuration file, /usr/sys/cf/dfile. 


The low level driver, sesi, which uses the device node 
/dev/scsi provides the interface to the system hardware and 
handles the SCSI bus interface and protocol. All the high level 
drivers interface through this device to the low level SCSI 
drivers. scsi must be an entry in the dfile, after the disk driver 
entries. 


The disk driver, sesidisk, provides the interface to SOSI disks. 
The current implementation only allows one copy of sesidisk in 
the system, supporting a maximum of 16 disks. Since there is 
only one copy of sesidisk in the system, only one line of 
scsidisk is needed in /usr/sys/cf/dfile, even if you have 
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multiple SCSI buses in the system. 


The tape driver, stape, provides interface to SCSI tape drives, 
both SCSI Quarter-Inch Tape drives and SCSI Half-Inch Tape 
drives. The current implementation supports a maximum of 8 
tape drives. stape may be an entry in the tape section of dfile, 
or the SCSI tape driver, /ete/Iddrv/stape.o, may be 
dynamically loaded. 


Refer to the S/Series CTIX Administrator’s Guide for details on 
software configuration of the SCSI subsystem. 
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10. Notes on System Operation 
10.1 A Note on System Tuning 


It is extremely important to tune your system for the Ethernet 
driver. If not configured properly, the number of stream 
buffers can become a bottle neck for Ethernet performance. It 
is recommended that the system should have at least 32 of 2k 
buffers. To reconfigure your system, add the following line to 
/ete/system, in the !TUNABLES section, under the 
*dsabldbg=1’ line: 


v_nblk2048—32 
Note that the symbol ’*’ in column 1 is a comment delimiter. 
Then run uconf to update the changes: 

uconf -w 


The changes are effective next time CTIX is rebooted. This 
note applies to both RFS and NFS network operation. See 
the uconf(1M) manual page for details. 


The system administrator should use netstat -m 
periodically to monitor stream buffer usage to tune the system. 
For example, if the failure rate in 1k stream buffer blocks is 
high, the number of 1K buffers should be increased. Refer to 
the S/Series Network Administrator’s Guide for more information. 


10.2 A Note on SCSI Half-Inch Tape Drives 


The Cipher Half-Inch Tape drives come up in fixed block mode 
as the default, so the mode must be changed by using the 
tapeset(1) command. The command does a MODE SENSE to 
the tape drive, removes the fixed block length bit, and then 
does a MODE SELECT to the drive. This sequence turns the 
tape drive into variable-length block mode. The drives do not 
support a density command. 


Some of the SCSI Half-Inch tape drives do not accept 
commands when off-line. Be sure your drive is on-line at boot 
time and at any time that a tapeset command is issued to the 
drive. 
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In the file /etc/tapedrives, the following lines have been added: 


F880S s 131072 12 000000000000000000000000 00007 fi ff ff ff ff fFOO000000 
M9908 s 131072 12 000000000000000000000000 00007 ff ff ff ff fff00000000 


Create the file /ete/reopts/KSCSI, if necessary, and add the 
following lines: 


tapeset -t F880S /dev/rmt/cOdic 
tapeset -t M990S /dev/rmt/cOdic 


Note that jumper W7 on the SCSI adapter for the Cipher F880S 
and M9908 should be removed, otherwise the drive will reset 
the SCSI bus every time power is cycled. 


10.3 Clist Usage 


The RS232 ports are now controlled by a STREAMS-based 
driver that does not make use of clists. The remaining serial 
devices that use clists are RS422 ports and the CT Window 
Manager driver, wet. Check /etc/inittab to obtain the number 
of active RS422 ports with getty spawned. Obtain the estimated 
maximum number of RS422 ports that will be using the CT 
Window Manager. The number of active clist users is the 
number of active RS422 ports plus two times the estimated 
number of CT Window Manager uses. The number of clists 
should be changed to the following number: 


((number of active clist ports) * 6) + 40 


10.4 Tty Device Nodes 


Note that cluster device nodes in /dev are not provided for 
/dev /tty288 and above, because they are needed only in case of 
large configurations. If you need the nodes, you must make 
them. Refer to the new man page createdev(1M) for 
information on creation of nodes. 


10.5 Process Sizes and Swap Space 


The sar -r report can be used to track the available swap space; 
if necessary, additional space can be allocated via the swap(1M) 
command. 


It is recommended that the swap area be at least one-half again 
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as much space as there is physical memory on the system. To 
obtain more swap space, use the swap(/1M) command with the 
-a option. There is no need to reconfigure the kernel or to 
reconfigure the disk to enlarge the original swap slice 
( /dev/rdsk/cOd0s2) when this is done. Please refer to the 
swap(1) entry in the CTIX Operating System Manual, Version C, 
Second Edition, Volume 1 and to Adding Swap Space with the swap 
CommandinChapter8 ofthe S/Series CTIX Administrator’s Guide. 


As an additional safety measure, CTIX restricts the maximum 
size that a process can be to 1/4 of the total available swap 
space plus IMB. This limit dynamically changes when a swap 
-a or swap -d is issued. This default ’floating’ max process 
size can be overridden by changing the maxumem variable in 
dfile and building a new kernel. A maximum value of 6144 
will allow a 24 MB process to be created. 


Note that the amount of virtual memory and physical memory 
is different for various members of the S/Series family. For 
the S/320 systems and the S/80, the maximum virtual memory 
is 32 MB and the maximum physical memory is 16 MB. For 
the S/640 systems, the maximum virtual memory is the full 
address space of the MC68020 (4 GB) and the maximum 


physical memory is 64 MB. ad 
10.6 Tuning the System for STREAMS Buffers 
The STREAMS buffer resources should be configured as shown 
below: 
Number per User 
Name Buffer Size 1 User 16 User 382 User 

nbik2048 2048 0 16 32 

nblk1024 1024 1 48 96 

nblk512 512 5 64 128 

nblk256 256 5 256 512 

nblk128 128 10 320 640 

nblk64 64 20 640 1280 

nblki6 16 20 512 1024 

nblk4 4 10 512 1024 a 

Ve’ 
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10.7 Configuring the System for the 4K Block File System 


If you want to create 4K file systems, you must configure your 
system to optimize performance. 


1. The system should have at least 3MB of physical memory. 


2. The 4K file systems should be created on disks of size 
85MB or more. 


3. The number of 4K buffers should be about one-fourth the 
number of 1K buffers. The number of 4K buffers in the 
kernel should be in the range of 16 to 32. The number of 
1K buffers is auto-configured at bootup. Check the 
number of 1K buffers, using the -v option of uconf(1M), 
and configure the number of 4K buffers accordingly, 
using the -w option of uconf(1M). 


10.8 Accessing Additional Disk Space on Larger Drives 


S/Series systems shipped with disk drives of size greater than 
40MB have many additional megabytes of space in a fourth 
partition which was formatted at installation but was not 
initialized with a valid file system structure. Refer to Chapter 
8, "Disks and File Systems”, in the SSeries CTIX Administrator’s 
Guide for instructions on how to create and mount file systems. 


10.9 Re-Partitioning Additional Disks 


S/Series systems shipped with more than one disk drive have 
only the first (system) disk initialized with more than one file 
system. The remaining disks are initialized with a Volume 
Home Block in partition O and a large file system in partition 1. 


For instructions on how to re-partition these disks into multiple 
file systems, refer to Chapter 8, "Disks and File Systems”, in the 
S/Series CTIX Administrator’s Guide. 


10.10 Some Notes About Cross Development 


Installation of the CROSS Group provides the capability to do 
software cross development for the following processors: 


e 68020 with software floating point (2sw) 
e 68020 with 68881 hardware floating point (2fp) 


The default libraries installed into your root file system under 
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/lib and under /usr/lib contain 68020 and software floating 
point objects. If your system has 68881 hardware floating 
point, and you plan to develop software only for the 68020 with 
68881 hardware floating point, you might want to install the 2fp 
libraries as the default libraries. (This eliminates the need for 
setting the LIBROOT environment variable to ’/cross/2fp’ 
upon compiling and linking.) 


e If the CROSS Group is not already installed, perform an 
update installation of the Group. (Refer to Section 5.2 of 
this release notice.) 


e If the entire CROSS Group is already installed, execute the 
/eross/crossins script to install one set of cross development 
libraries into the root file system. This script also changes 
the definition of CENVIRON in /ete/profile, and allows the 
removal of extraneous cross development libraries from 
/cross. 


Please refer to the ce{1) and [d(1) pages in the CTIX Operating 
System Manual, Version C, Second Edition, Volume 1 and to the 
Programmer’s Notes for C Cross Compiler and Flexnames 
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11. Known Errors, Restrictions, and Warnings 
11.1 Known Errors 


Known errors at the time of release of 6.2 CTIX are listed 
below. 


1. 


When NFS runs out of inodes, you get the warning: 
nfs_iget: rnode table overflow 

Shortly after that the system panics with a 
Page 0 access in kernel 


To avoid this problem, increase the default value of 50 
for the nfs_rnum entry in /ete/system. 


1.1 RFS will only allow you to execute 64 pairs of the 
commands rfstart(1M) and rfstop(1M). Thereafter, you 
must reboot the system, in order to bring up RFS. 


crash(1M) has not been completely converted to handle 
both STREAMS-based and clist-based serial ports. The 
following crash(1M) commands currently work correctly: 
ser, vt. The following commands do not work: pt, gt, 
wxt, clist, cblk. The command tty works in so far as it 
reports STREAMS-based ports. The command ser -f 
works correctly for non-IOP controlled ports but will 
report bogus values for the device structure (see 
/usr/include/sys/serial.h). 


If you add SOSI disk drives to the onboard SOSI bus 0, 
you must add them in decending sequence, in order to 
satisfy the built-in SCSI map. Use the example below as a 
guide. 


disk-cOdO0 bus=O target—6 lun=0 parity reselect 
disk-cOdl bus=0 target—5 lun—O parity reselect 
disk-cOd2 bus=0O target—4 lun=0 parity reselect 
tape-d0 bus=0 target—1 lun=0 parity reselect 


crash{1M) might successfully read an S/280 disk dump 
area. 


If remd(1) calis a remote command which calls another 
command in the background, the original remd(1) will not 
terminate until the background job terminates. 
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10. 


11. 


12. 


13. 


14. 


15. 


16. 


If you try to create a disk crash dump area of size 64 MB, 
tw(1M) writes a O size dump area, but the installation 
script Rawlnstall reserves 64 MB of disk space. The work 
around is to create a dump area of less than 64 MB. This 
problem is of minor severity, since it is unlikely that you 
would want to give that much disk space to crash dumps. 


iv -iv cannot format SCSI disk drives if there are trailing 
spaces on any line of the description file. 


Systems with a SCSI bus might report accumulating SCSI 
data I/O errors, even though no data corruption or loss 
occurs. The errors cause retries that are eventually 
successful, but the errors are still being logged. 


The new utility serstat(1M) might dump core when the 
mode (scan, auto-scan, or continuous) is changed. 


You will get an inappropriate message when executing a 
command with dd piped to tio with different block sizes 
specified for writing and reading the tape: 


reach end of medium 
instead of 
change tape ... 


On the $/320 systems and the S/80, when you execute 
tsioctl -c erase with a write-protected tape, the command 
returns immediately with a status value of 0. 


With the VME Half-Inch Tape driver, tsioct] -c skip does 
not identify two end-of-file (EOF) marks as End-of-tape 
(EOT). This can cause the unit to wind the tape off the 
supply reel. 


Setting dbconsole in /etc/rcopts/LOCDRVLD causes the 
system to never get to login state. Enter the command 
after the system has come to multi-user run level. 


If the kernel debugger and symbols drivers are loaded but 
dsabldbg is not set to 0, then if the system panics symbols 
are not displayed. 


When in the kernel debugger, you cannot select output to 
go to printer or to log file. 
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17. 


18. 


19. 


20. 


21. 


22. 


If the superuser executes 
ec -o dirname somefile.c 


the loader, Id(1), will use the system call unlink(2) to 
remove the specified output file, even though it is a 
directory! A regular user will get the message 


ld fatal: cannot create output file . 


The C compiler link-loader, Id(1), will hang forever if 
/usr/tmp runs out of space. 


If the user tries to set the Half-Inch Tape drive to low 
density by executing: 


echo < /dev/rmt/c? d?1 
the tape drive unloads the tape. 


usage(1) in print command list mode causes the top line on 
the screen to be offset. Also when a command with a 
large usage description is printed, the first screenful is 
displayed with.a more at the bottom, but nothing further 
can be displayed. 


If you use getline on the last line of a file that does not 
have a final newline, awk(1) will coredump. 


SPR 12131: The compiler does not correctly pad 
structures which contain fields of type enum. As an 
example, consider the following structure definition: 


enum a { abede } 
struct str { 
enum a al, a2, a3; 
char arr[6]; 


} 


The size of this structure on an MC68010 based system is 
18 bytes. On an MO68020 system it is 20. The MC68020 
compiler pads the structure with two bytes after the 6 byte 
array. This is incorrect because it is incompatible with an 
earlier version of the compiler. Unfortunately, fixing this 
problem would cause significant compatibility problems 
for existing users of the compiler. 
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23. 


24. 


25. 


26. 


27. 


28. 


Floating point: There are a number of known floating 
point errors which are documented by internal SPR’s. 
These errors are all related to incorrect return values from 
floating point conversions in overflow situations, such as 
when a NaN is involved in an expression. See the [EEE 
Standard for Binary Floating-Point Arithmetic, P754, for a 
detailed discussion of NaN. 


If your system has a cluster of PT or GT terminals and 
one of them develops a hardware problem, the system 
might crash with a panic message: 


pt_recv: too much input 


The work-around is to pull the offending terminal out of 
the cluster chain. 


If the CT Window Manager, ctwm, is used, the passwd({1) 
program cannot determine who you are. Use passwd 
user_name. 


When illegal options are given to uconf(1M), it might 
respond with bogus error messages. Also it does not 
check for out-of-range inputs, nor suggest proper values. 


There are many minor bugs and omissions, too numerous 
to mention, in AT&T’s ASSIST package. The package is 
provided but will not be upgraded to fix these deficiencies. 


If too many printers are active in the spooler, error 
messages about "too many processes” are generated, 
because [p(1) as a user process, is limited to 25 processes. 
There are several solutions: 


1. Change /usr/sys/cf/dfile to increase the parameter 
maxproc to 50 and then rebuild the kernel, link it to 
/unix, and reboot. 


2. Change the kernel parameter v_maxup with 
uconf(1M) and reboot the system. 


3. Set up the spooler to run with individual UID’s per 
printer spool. (Keep the group ID the same.) 
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11.2 Restrictions 


Restrictions known to apply at the time of release of 6.2 CTIX 
are listed below. 


1. 


For ports controlled by an IOP, up to 4 ports are 
guarenteed to support SLIP lines. 


The encryption /decription functionality related to crypt(1) 
is not contained in this release. There is not a man page 
for crypt{1) in the current CTIX manual set. There is a 
separate crypt(1) product. 


You must have at least 3 MB of memory in order to run 
TOP/IP, RFS or NFS, and applications. 


The utility uugetty(1) should be used with the -r option. 
Note that the new version (to handle STREAMS-related 
changes) will take as much as five seconds to return a 
login prompt. 


If you execute shutdown(1M) and attempt to return to 
multi-user level (init state 2 or 3) without rebooting the 
system, some system services will not be restarted and if 
your /usr is mountable, it will not be mounted. 


fip(1) does not support ksh (the new AT&T Korn shell). 
You will get the message "access denied” if you try to use 
ftp(1) from this shell. 


6.2 S/Series CTIX does not support the Convergent TO- 
300 Terminal PC compatible keyboard. 


You must add at least 1 MB of Expansion Memory to an 
S/80 machine in order to run 6.2 CTIX without problems. 
The 6.2 CTIX kernel is much larger than the 6.10 CTIX 
version, because all drivers are now included in the 
kernel. The S/320 systems drivers (the SMD disk driver, 
QIC-2 tape driver, RS-422 cluster device driver, ST506 
disk driver, VME interface driver, and the VME Half- 
Inch Tape driver) are not needed by the S/80 systems. 
To remove them, you must change /usr/sys/cf/dfile, 
rebuild and install the kernel, and reboot your system. 


The Convergent Window Manager ctwm does not work in 
6.2 CTIX, due to the STREAMS-based implementation of 
tty. 
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10. 


11. 


12. 


13. 


14. 


15. 


16. 


17. 


The adman(i) menu for adding a printer does not allow 
you to chose your model file. Also adman(1) does not 
provide an menu for deleting a printer model. 


If adman is used to add a dial-in only modem, and then 
you try to delete the modem later, adman will claim that 
there are no modems configured. Since the modem was 
defined as dial-in, there is no entry for it in 
/usr/lib/uucp/Devices. 


PCX will not support RS-422 cluster devices in 6.2 CTIX. 


adman(1) does not support administration of the TCP/IP 
daemon named(1C). adman(1) should not be used for 
administration of TCP/IP. 


If adman(1) is used on the system console (usually 
/dev/tty000), there may be messages sent to the screen 
that adman cannot trap, especially if the kernel debugger 
is loaded and enabled. When adman(1) is using hinv(1), 
the output will be sent directly to the console and it will 
overwrite the adman screen. 


fstyp(1M) always reports a file system as S51K, whether it 
is 1K or 4K, because the size block is independent of the 
file system type. 


The [p(1) spooler does not allow printer names longer 
than 13 characters. 


The -s option for éstoctl(1) is not implemented for SCSI 
tape drives. You will get an error message if you attempt 
to use it. 


11.3 Compatibility Issues 


The following changes have been made: 


1. 


The Motorola MC68010 cross compilation libraries are no 
longer provided in the CROSS Group. The 68010 
compiler has not been removed. 


The openi2) 
system call is no longer supported. 
The libtermcap.a and libtermlib.a libraries are now 


provided by linking to libeurses.a. This means that they 
are now based on terminfo and not on termcap. This 
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5. 


means that the TERMCAP environment variable is not 
recognized by programs linked with this library. The old 


termcap versions of these libraries are provided as 
libotermcap.a and libotermlib.a. 


The capability to set a negative nice value (and thus fixing 
the priority of a process) has been changed so that it must 
be enabled in the system before it is operative. This 
change has been made so that the released system can be 
SVID compatible. The mechanism may be enabled by 
executing /etc/rtpenable -e (as root), or a program 
executing the syslocal(SYSL_RTNICE,1) system call 
(again as root). This capability can be automatically 
enabled at system boot by creating the zero length file 
/ete/rcopts /ENABRTNICE. 


A change in System V.3 (and hence in 6.2 CTIX) is the 
new definition of the signal system call from "extern 
int{ *signal())();” to "extern void(*signal())();”. 


The files controlling the boot process are substantially 
different in 6.2 CTIX from those in 5.XX CTIX. The 
files in /etc/rcopts control options in the initialization 
scripts. The files in /ete/rcopts are not provided on the 
CTIX Distribution tape; hence, customizations via this 
mechanism simplify reconfiguration on new installations. 
A lot of actions have been extracted from /ete/re, which 
is no longer used and has been replaced by /ete/rcO, 
/ete/re2, and separate scripts in /ete/init.d. These scripts 
are then linked to files in /ete/re0.d and/or /ete/re2.d. 
These files are not marked as customizable in the 6.2 
S/Series CTIX distribution. It is intended that their 
actions are modified by the presence of files in 
/ete/rcopts. In many cases local customizations may be 
provided by creating scripts in /etc/reopts. See 
/ete/rcopts/README for a brief description of the 
options. 


A number of customizable files (/ete/inittab, 
/ete/checklist, /etc/drvload), contain changes that are 
important for the successful operation of the system. As 
such it is important that these files are not ignored during 
imstallation. It is also important that when applying 
customizations from an_ earlier release that the 
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11.4 


customizations be added to the new versions. An 
example is /ete/checklist, the new version specifies the 
root file system as the blocked device and all other file 
systems as the raw disk. If the root file system is 
specified in /etc/checklist as the raw disk the system 
enters a loop of booting, entering ADMIN mode, you run 
fsck(1M), reboot the system and enter ADMIN mode, etc. 
fetcfdrvload manipulates a number of files that are 
involved with controlling the new capabilities provided by 
fetcddrvfddrv in this release, hence it is important to use 
the new drvload or drivers will not load. /etc/inittab now 
invokes fetc/rc2 to enter init state 2. The old inittab 
invoked /etc/re (which is moved to /ete/OLDre as part of 
the installation), hence the old inittab must not be used. 


Warnings 


The products listed below are known not to function 
correctly under 6.2 CTIX. 


Revision Product 
2.20 S/Series CTAM 
2.20 PCX 


S/Series WGS installation overwrites some of the 
ADMAN Group files, so you must reinstall the ADMAN 
Group. 


Shell layers does not work on an RS-422 line. The shell 
layers driver and the RS-422 cluster line driver both use 
multiplex line discipline and cannot be _ active 
concurrently. 


You must use the new 3.2 TCP/IP release with 6.2 
CTIX. 


If you want the system to be a gateway, you must make 
some modifications. If the system is at multi-user level, 
execute a shutdown. When the system is at single-user 
level, do the following: 


e To the file /ete/system on the gateway system, add 
the line: 
net_ipforwarding=1 
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Lo 


on 


10. 


11. 


12. 


e To update your kernel, execute: 
uconf -w 


e Reboot your system. 


If you are using NFS, you must first install 6.2 CTIX, 
then 3.2 TCP/IP, and finally reinstall 1.0 NFS. 6.2 
CTIX will overwrite some NFS files. 


If you are using RF'S, you must update to 1.1 RFS. You 
must first install 6.2 CTIX, then 3.2 TCP/IP, and finally 
1.1 RFS. 


The semop(2) system call returns the value of the 
semaphore in 5.2X CTIX. In 6.00, 6.10, and 6.2 CTIX, it 
returns 0 if successful and -1 otherwise. 


uconf(1M) must be used carefully. It does not check 
validity of some inputs; for example, if recs is increased 
beyond a reasonable value, the kernel will fail to reboot. 
(Always keep a copy of the old kernel until certain that a 
new reconfiguration won’t fail.) 


Newer versions of the SCSI-based systems use a 150 MB 
SCSI Quarter-Inch Tape drive. Tapes written on this 
drive cannot be read by the older 60 MB SCSI Quarter- 
Inch Tape drives. Tapes written on the 60 MB drive can 
be read on the 150 MB drive. Crash dump tapes labeled 
on the 60 MB drive cannot be used on a 150 MB drive. 
First erased the tape and then re-label it. 


For the S/80 and S/640, the disk node cO0d0 on bus 0, is 
the rootdev. Don’t change the entry for this node in the 
!ISCSIMAP section of the system configuration file, 
/ete/system. 


On an S/80, on bus 0, the target ID 0 is reserved for the 
SCSI/Ethernet controller. Don’t use this ID number in 
the SCSIMAP section of the system configuration file, 
/ete/system. 


If your system is running NFS and the server runs out of 
disk resources, you will get messages about "WARNING: 
NFS getattr failed for server XXXX: TIMED OUT”, and 
eventually your system will panic. The administrator of 
the server system must monitor working disk space. This 
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13. 


14. 


15. 


16. 


17. 


18. 


19. 


20. 


21. 


22. 


bug is fixed in UNIX System V Release 4. 


The S/PC CTIX/386 RFS routine getservaddr swaps the 
first two bytes of the expanded internet address. This 
callses remote mounting failures between S/Series and 
S/PC systems. The fix is to edit the S/PC file 
/usr/nserve/rfmaster to swap the bytes. 


If you are converting network file system server from 
RFS to NFS or from NFS to RFS, you must convert 
remote mount entries in the file /etc/fstab. 


If a kernel is built using /usr/sys/cf/dfilerfs or 
/usr/sys/cf/dfilenfs without the entry for socket, the 
drivers that require the socket driver will fail to load. 
druload(1M) will not load the socket driver. It will 
complain about redefines and not being able to find entry 
points. 


Adman will allow you to add a modem to a port that 
already has a getty for a terminal running on it. 


If your system is configured for Ethernet, you cannot take 
the system to single-user run-level and then go from 
single-user run-level to multi-user run-level. The system 
almost comes all the way up, but never starts any gettys. 


There is a swap area problem that can cause the system to 
panic. It occurs when an I/O error occurs during a read 
or write of the swap area. 


An Ip destination printer name of 14 character length is 
disabled by the scheduler, so make the names 13 
characters or less. 


If you w(1M) a SCSI disk and mistakenly specify the size 
of the last slice to be greater than the actual size, and 
then make a file system on the slice using the /dev/dsk 
device node, the system will crash with a SCSI panic 
message. 


Be careful using the (1) command. iv -i of 
/dev/rdsk/cOd0s0 reinitializes the system disk, which 
implies destroying the existing CTIX system. 


The kernel libraries in /usr/sys and the dfile files in 
/usr/sys/cf will be overwritten. If you are customizing 
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x 


i 


23. 


25. 


the kernel for a product, please review the product 
Release Notice. 


The -f option for as(1) is not supported. 


If you are using pseudoterminals, you may want to 
increase the number of clists. Consult the S/Series CTIX 
Administrator’s Guide. 


The file /usrfzb /fmailz/mailz.re executes a source on the file 
/usr/lib/mailx/local.re, which as delivered is empty. 
mailz.re is used by madz(1). 


You must create local.rce, as in the following example: 


# local.re 

set sendmail = /usr/lib/sendmail 

# Management system 

group mgradmin greg 

alias greg adminsys! greg 
alias Greg Holden greg 

# Inventory system 


group invadmin sam greg 
alias sam inventory!sam 
alias Sam_Wooster sam 


Refer to the S/Series CTIX Administrator’s Guide for more 
information. 
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12. Documentation Updates 


12.1 Available Documentation 


The following documents accompany this software release: 


1. 


2. 
3. 


CTIX Operating System Manual, Version C, Second 
Edition, in four volumes. 


S/Series CTIX Administrator’s Guide 
CTIX Administration Tools Manual 


12.2 CTIX Documentation Update 


Some documentation deficiencies will be addressed in this 
section. 


1. 


The man page for mes(1) is incorrect. mcs(1) does not 
use the environmental variable TMPDIR. It explicitly 
uses /usr/tmp. 


The man page for masterupd(1M) is included in the latest 
version of the CTIX Operating System Manual, but the 
utility is not included in the 6.2 CTIX release. 


6.2 S/Series CTIX uucp(1C) is simpler to configure for 
autodialers or smart modems. The 
/usr/lib/uucp/modemcap file no longer exists. It is 
replaced by the /usr/lib/uucp/Dialers file. Please refer 
Chapter 10, "UUCP”, in the S/Series CTIX Administrator’s 
Guide. 


The Ip(1) command has been added to the default 
commands executable from a remote system with 
uuz(1C). The other defaults are rmai(1) and rnews(1). 


See the S/Serites CTIX Admuinistrator’s Guide for 
information on how to configure your system for 
Ethernet. 


The SMAIL Group installs the sendmad(1C) package. 
Refer to Chapter 15 of the S/Series CTIX Admuinistrator’s 
Guide for advice on configuration and operation. The 
sendmail package is difficult to administer, so install it only 
if you want it. 
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